home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / comms / dtmf_d.zip / DTMF_D.DOC < prev    next >
Text File  |  1995-01-16  |  6KB  |  157 lines
  1.                     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  2.                              DTMF decoder DEMO version
  3.                     Shima-nized Advanced Utilities - J.M. Shima
  4.                           Copyright (c) 1994-95 by James Shima
  5.                                 All Rights Reserved
  6.                     ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  7.  
  8.  
  9.                    ▐▐▐▐   R E F E R E N C E   M A N U A L   ▐▐▐▐
  10.  
  11.  
  12.  
  13.             » Type DTMF_D at the DOS prompt for a summary of options «
  14.  
  15.  
  16.  
  17. INTRODUCTION
  18. ▀▀▀▀▀▀▀▀▀▀▀▀
  19.  
  20. * This program is capable of post processing DTMF tones and decoding the
  21.   numbers from a given input sound file.  The sound file has to be sampled
  22.   at a 8kHz sampling rate.  One application where DTMF tones are used
  23.   is in the standard American telephone dialing system.  The standard
  24.   DTMF tones represent the numbers 1,2,3,4,5,6,7,8,9,0,*,# on a standard
  25.   keypad interface.
  26.  
  27. * The source sound file has to be binary or a Soundblaster 8-bit .VOC file.
  28.  
  29. * This program accepts COMMAND-LINE ARGUMENTS that are passed to the
  30.   DTMF decoder.
  31.  
  32. * For a list of the arguments, type DTMF_D at the DOS prompt.
  33.  
  34. * The DEMO only decodes a maximum of 5 numbers.  Interested
  35.   persons can purchase the full-blown REGISTERED version with no limitations.
  36.  
  37. * An example of the input arguments are:
  38.  
  39. Usage:  DTMF_D <in_file> <thresh> <sblast>
  40.  
  41. <in_file> --> input sound file name.
  42.  
  43. <thresh> -->  The threshold that the DTMF tones must exceed over the
  44.               noise floor for detection (in dB).  Typically, strong
  45.               DTMF tones will be 20-40 dB stronger than the noise
  46.               in the signal.  However, noisy signals lower this
  47.               signal-to-noise (S/N) ratio.  The threshold parameter
  48.               allows the user to set the S/N threshold for detection.
  49.               NOTE:  If nothing is entered, then the default thresh value
  50.               is 20dB.
  51.  
  52. <sblast> --> Set to this to a 1 for a Soundblaster .VOC file, else set
  53.              it to 0.  NOTE: If nothing is entered, the default is 1, i.e.
  54.              a .VOC file is selected.
  55.  
  56.  
  57. IMPORTANT NOTES BEFORE USE
  58. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  59.  
  60. ** For the DEMO program, your input .VOC or binary file * MUST BE SAMPLED *
  61.    at a 8kHz rate (no exceptions) for correct results.
  62.    The industry standard for DTMF sampling is 8kHz, and this demo program
  63.    uses that sample rate in its calculations!!
  64.  
  65. ** A binary file consists of samples that are stored as 2's complement
  66.    numbers.  In other words, the samples take on values from [-128, 127].
  67.    
  68.  
  69. EXAMPLES OF RUNNING DTMF_D
  70. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  71.  
  72. DTMF_D dtmf800.voc 25 1   --> input file is dtmf800.voc, threshold S/N
  73.                               ratio is 25dB, soundblaster .VOC file type is
  74.                               selected.
  75.  
  76. DTMF_D dtmf800.voc        --> input file is dtmf800.voc, threshold DEFAULTS
  77.                               to 20dB S/N ratio, soundblaster file type
  78.                               is selected by DEFAULT.
  79.  
  80. DTMF_D junk.dat 20 0      --> input file is junk.dat, thresh=20dB, binary
  81.                               file type is selected.
  82.  
  83.  
  84. INCLUDED FILES
  85. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  86.  
  87. DTMF_D.EXE   -->  DTMF demo decoder.
  88. DTMF800.VOC  -->  DTMF number 1-800-555-1212 stored in a .VOC file.
  89. DTMF_1.VOC   -->  DTMF number 1 stored in a Soundblaster .VOC file.
  90. DTMF_7.VOC   -->  DTMF number 7 stored in a Soundblaster .VOC file.
  91. DTMF_D.DOC   -->  This file.
  92. REGISTER.DOC -->  Registration form.
  93.  
  94.  
  95. REGISTRATION
  96. ▀▀▀▀▀▀▀▀▀▀▀▀
  97.  
  98. ** For registration, please fill out REGISTER.DOC and see the DEMO screen.
  99.    Specify media dispersement.
  100.  
  101. The enhanced REGISTERED version of this program allows unlimited decoding
  102. of numbers, and offers many other features INCLUDING:
  103.  
  104. 1) File types supported include: .VOC, .WAV, and raw signed binary files.
  105.    Input file types are auto detected.
  106.  
  107. 2) Fast detection mode, which doubles the speed of decoding.
  108.  
  109. 3) Flexible sampling rate.  The program adapts to sample rates other than
  110.    the standard 8kHz.
  111.  
  112. 4) Automatic logging of the resulting decoded numbers to a log file.
  113.  
  114. 5) Multiple-file input mode, so uninterrupted decoding and logging happens
  115.    without user intervention.
  116.  
  117. ** REGISTERED users will also receive a DTMF generator program.  This is
  118.    a DTMF tone generator which allows you to create any DTMF sequence
  119.    you wish.  The program allows you to specify a DTMF number sequence,
  120.    the sampling rate, and how long you want the pulses to be (in samples).
  121.  
  122.  
  123. SOFTWARE LICENSE
  124. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  125.  
  126. The DEMO version of the DTMF decoder is shareware, and is free to be
  127. used for personal use only.  This is true as long as the DEMO is
  128. not alterted in any fashion.  Registered users will receive the enhanced
  129. version of the DTMF decoder and will receive documentation stating such.
  130.  
  131. I have thoroughly tested this code and am not responsible for any mishaps
  132. that may happen when launched on your computer.  The code was tested on
  133. a IBM compatible 25MHz 386DX PC with a Soundblaster Ver. 1.5, 8-bit sound
  134. card, running DOS 5.0.  For optimal performance, DO NOT run this program
  135. while under Microsoft Windows.
  136.  
  137. Every action has been taken to ensure an error-free program.
  138.  
  139. Use this program at your own risk, as I assume no responsibility in your
  140. actions while you are using this program.  Invoking the program is your
  141. compliance to this statement.
  142.         
  143. Good luck!
  144.  
  145. For more information,
  146. email:  James Shima
  147.         shima@eel.ufl.edu
  148.  
  149.  
  150. TRADEMARKS
  151. ▀▀▀▀▀▀▀▀▀▀
  152.  
  153. Soundblaster and Creative Voice File are trademarks of Creative Lab's Inc.
  154. Microsoft Windows and DOS are trademarks of Microsoft.
  155.  
  156.  
  157.